@OpenHands Read the initial description. It says in follow ups:

Document an “Errors” section in the SDK README with example client handlers

Lets document, but not in the README, instead clone yourself the docs repo from the same org, understand the structure and find the best place to add docs on SDK Exceptions for client developers to know and handle as they want. Then add it. Open a PR to docs.

I'm on it! enyst can track my progress at all-hands.dev

Summary of changes since last update

I completed the documentation work for SDK Error Handling & Exceptions and opened a PR to the docs repository. Key updates:

• New guide page:

  • Path: sdk/guides/error-handling.mdx
  • Content:
    • Explains provider-agnostic exception mapping
    • Try/except examples for both LLM.completion() and LLM.responses()
    • Agent/Conversation flow example with and without a condenser
    • Clear recommendation to enable a condenser to avoid context-window interruptions
    • Exception reference covering LLMContextWindowExceedError, LLMAuthenticationError, LLMRateLimitError, LLMTimeoutError, LLMServiceUnavailableError, LLMBadRequestError, parsing/validation errors, and cancellation types (all inherit from LLMError except explicit cancellations)
  • Follow-up commit added a dedicated Responses API example

• Navigation:

  • Added the page under SDK → Guides → LLM Features in docs.json

• Git/PR:

  • Branch: sdk/error-normalization-context-auth
  • Commit 1: “SDK: Document error handling & typed exceptions”
  • Commit 2: “SDK: Add Responses API example to error handling guide”
  • PR: SDK: Document error handling & typed exceptions docs#91 (references SDK PR Normalize SDK errors for clients #980)

Checklist

• Place page under SDK → Guides → LLM Features: done
• Document provider-agnostic mapping and recommended handling patterns: done
• Include examples for LLM.completion(), LLM.responses(), and agent/conversation flows: done
• Recommend condenser usage for context-window issues: done
• Create docs branch, commit with Co-authored-by, push, open PR referencing SDK PR Normalize SDK errors for clients #980: done

Diff summary (concise)

• Added sdk/guides/error-handling.mdx
• Updated docs.json to include "sdk/guides/error-handling" under LLM Features
• Follow-up commit added explicit Responses API example

PR link

• SDK: Document error handling & typed exceptions docs#91

_{View full conversation}